<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content=
    "application/xhtml+xml; charset=iso-8859-1" />
    <title>
      libidn-1.35
    </title>
    <link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.79.1" />
    <link rel="stylesheet" href="../stylesheets/lfs-print.css" type=
    "text/css" media="print" />
  </head>
  <body class="blfs" id="blfs-9.1">
    <div class="navheader">
      <h4>
        Beyond Linux<sup>�</sup> From Scratch <span class="phrase">(System
        V</span> Edition) - Version 9.1
      </h4>
      <h3>
        Chapter&nbsp;9.&nbsp;General Libraries
      </h3>
      <ul>
        <li class="prev">
          <a accesskey="p" href="libical.html" title="libical-3.0.7">Prev</a>
          <p>
            libical-3.0.7
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="libidn2.html" title="libidn2-2.3.0">Next</a>
          <p>
            libidn2-2.3.0
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="genlib.html" title=
          "Chapter&nbsp;9.&nbsp;General Libraries">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 9.1">Home</a>
        </li>
      </ul>
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <h1 class="sect1">
        <a id="libidn" name="libidn"></a>libidn-1.35
      </h1>
      <div class="package" lang="en" xml:lang="en">
        <h2 class="sect2">
          Introduction to libidn
        </h2>
        <p>
          <span class="application">libidn</span> is a package designed for
          internationalized string handling based on the <a class="ulink"
          href="http://www.ietf.org/rfc/rfc3454.txt">Stringprep</a>,
          <a class="ulink" href=
          "http://www.ietf.org/rfc/rfc3492.txt">Punycode</a> and <a class=
          "ulink" href="http://www.ietf.org/rfc/rfc3490.txt">IDNA</a>
          specifications defined by the Internet Engineering Task Force
          (IETF) Internationalized Domain Names (IDN) working group, used for
          internationalized domain names. This is useful for converting data
          from the system's native representation into UTF-8, transforming
          Unicode strings into ASCII strings, allowing applications to use
          certain ASCII name labels (beginning with a special prefix) to
          represent non-ASCII name labels, and converting entire domain names
          to and from the ASCII Compatible Encoding (ACE) form.
        </p>
        <p>
          This package is known to build and work properly using an LFS-9.1
          platform.
        </p>
        <h3>
          Package Information
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "https://ftp.gnu.org/gnu/libidn/libidn-1.35.tar.gz">https://ftp.gnu.org/gnu/libidn/libidn-1.35.tar.gz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download (FTP): <a class="ulink" href=
                "ftp://ftp.gnu.org/gnu/libidn/libidn-1.35.tar.gz">ftp://ftp.gnu.org/gnu/libidn/libidn-1.35.tar.gz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: bef634141fe39326cb354b75e891fead
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 4.0 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated disk space required: 25 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated build time: 0.2 SBU (using parallelim=4)
              </p>
            </li>
          </ul>
        </div>
        <h3>
          libidn Dependencies
        </h3>
        <h4>
          Optional
        </h4>
        <p class="optional">
          <a class="xref" href="pth.html" title="Pth-2.0.7">Pth-2.0.7</a>,
          <a class="xref" href="../postlfs/emacs.html" title=
          "Emacs-26.3">Emacs-26.3</a>, <a class="xref" href="gtk-doc.html"
          title="GTK-Doc-1.32">GTK-Doc-1.32</a>, <a class="xref" href=
          "openjdk.html" title="OpenJDK-12.0.2">OpenJDK-12.0.2</a>, <a class=
          "xref" href="valgrind.html" title=
          "Valgrind-3.15.0">Valgrind-3.15.0</a>, and <a class="ulink" href=
          "http://www.mono-project.com/">Mono</a>
        </p>
        <p class="usernotes">
          User Notes: <a class="ulink" href=
          "http://wiki.linuxfromscratch.org/blfs/wiki/libidn">http://wiki.linuxfromscratch.org/blfs/wiki/libidn</a>
        </p>
      </div>
      <div class="installation" lang="en" xml:lang="en">
        <h2 class="sect2">
          Installation of libidn
        </h2>
        <p>
          Install <span class="application">libidn</span> by running the
          following commands:
        </p>
        <pre class="userinput">
<kbd class="command">./configure --prefix=/usr --disable-static &amp;&amp;
make</kbd>
</pre>
        <p>
          To test the results, issue: <span class="command"><strong>make
          check</strong></span>.
        </p>
        <p>
          Now, as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class="command">make install &amp;&amp;

find doc -name "Makefile*" -delete            &amp;&amp;
rm -rf -v doc/{gdoc,idn.1,stamp-vti,man,texi} &amp;&amp;
mkdir -v       /usr/share/doc/libidn-1.35     &amp;&amp;
cp -r -v doc/* /usr/share/doc/libidn-1.35</kbd>
</pre>
      </div>
      <div class="commands" lang="en" xml:lang="en">
        <h2 class="sect2">
          Command Explanations
        </h2>
        <p>
          <em class="parameter"><code>--disable-static</code></em>: This
          switch prevents installation of static versions of the libraries.
        </p>
        <p>
          <code class="option">--enable-gtk-doc</code>: Use this parameter if
          <span class="application">GTK-Doc</span> is installed and you wish
          to rebuild and install the API documentation.
        </p>
      </div>
      <div class="content" lang="en" xml:lang="en">
        <h2 class="sect2">
          Contents
        </h2>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Installed Program:</strong>
              <span class="segbody">idn</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Library:</strong>
              <span class="segbody">libidn.so</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Directories:</strong>
              <span class="segbody">/usr/share/doc/libidn-1.35 and
              /usr/share/gtk-doc/html/libidn</span>
            </div>
          </div>
        </div>
        <div class="variablelist">
          <h3>
            Short Descriptions
          </h3>
          <table border="0" class="variablelist">
            <colgroup>
              <col align="left" valign="top" />
              <col />
            </colgroup>
            <tbody>
              <tr>
                <td>
                  <p>
                    <a id="idn" name="idn"></a><span class=
                    "term"><span class="command"><strong>idn</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a command line interface to the internationalized
                    domain name library.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="libidn-lib" name="libidn-lib"></a><span class=
                    "term"><code class="filename">libidn.so</code></span>
                  </p>
                </td>
                <td>
                  <p>
                    contains a generic Stringprep implementation that does
                    Unicode 3.2 NFKC normalization, mapping and prohibition
                    of characters, and bidirectional character handling.
                    Profiles for Nameprep, iSCSI, SASL and XMPP are included
                    as well as support for Punycode and ASCII Compatible
                    Encoding (ACE) via IDNA. A mechanism to define Top-Level
                    Domain (TLD) specific validation tables, and to compare
                    strings against those tables, as well as default tables
                    for some TLDs are included.
                  </p>
                </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <p class="updated">
        Last updated on 2020-02-16 12:25:07 -0800
      </p>
    </div>
    <div class="navfooter">
      <ul>
        <li class="prev">
          <a accesskey="p" href="libical.html" title="libical-3.0.7">Prev</a>
          <p>
            libical-3.0.7
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="libidn2.html" title="libidn2-2.3.0">Next</a>
          <p>
            libidn2-2.3.0
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="genlib.html" title=
          "Chapter&nbsp;9.&nbsp;General Libraries">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 9.1">Home</a>
        </li>
      </ul>
    </div>
  </body>
</html>
